在專案中，我們常常需要重複使用某些資料處理邏輯，例如：

• 資料格式轉換
• 參數包裝
• 特定演算法
  這時就可以自訂全域的 Helper function，讓整個專案都能使用。

步驟一：建立 Helper 檔案

可以將自訂函式放在 app/Helpers/Helper.php：

<?php

if (! function_exists('wrapArrayIfNotList')) {
    function wrapArrayIfNotList($data): array
    {
        if (is_null($data)) {
            return [];
        }
        return array_is_list($data) ? $data : [$data];
    }
}

步驟二：在 composer 中載入 Helper 檔案

修改 composer.json，加入以下設定：

"autoload": {
    "files": [
        "app/Helpers/Helper.php"
    ]
}

步驟三：執行 autoload 重建指令

composer dump-autoload
執行完後，Helper 函式就能在整個專案中直接使用！

使用方式範例

$data = ['name' => 'Harry'];
$arrayData = wrapArrayIfNotList($data);